home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / win_utl1 / irdc240.zip / IRDCDOS.EXE / IRDQ.DOC < prev    next >
Text File  |  1996-04-05  |  19KB  |  386 lines
  1. --------------------------------------------------------------------
  2. IRDQ - INFRA-RED Command Line Control
  3. --------------------------------------------------------------------
  4. Version 2.40
  5. April 1996
  6.  
  7. Copyright 1993-1996 - D.Huras - All Rights Reserved
  8.  
  9. ------------------------------------------------IRDQ.DOC v2.40------
  10. CONTENTS
  11. --------------------------------------------------------------------
  12.  1. DESCRIPTION
  13.  2. WARRANTY
  14.  3. SETUP INSTRUCTIONS
  15.  4. COMMAND LINE ARGUMENTS
  16.  5. IRDQ DOS ENVIRONMENT VARIABLE
  17.  6. BUTTON NAMES
  18.  7. PROGRAM OVERVIEW
  19.  8. RELEASE HISTORY
  20.  
  21. 1. DESCRIPTION
  22. --------------------------------------------------------------------
  23. IRDQ is a program that sends commands to a ONE FOR ALL (*1) Remote
  24. Control that instruct the remote control to emit INFRA RED (I/R)
  25. signals.  Essentially, IRDQ emulates a person pressing buttons on
  26. the remote control keypad.  Any button sequence that can be
  27. physically entered on the remote control keypad can be emulated with
  28. the IRDQ program including setting the Device type.
  29.  
  30. IRDQ is a companion program to IRDC.   The full functioning version
  31. of IRDQ is supplied with the Registered Version of IRDC.  A limited
  32. function (*2) version of IRDQ is supplied with the Shareware Version
  33. of IRDC.
  34.  
  35. This brief document focuses on the use of IRDQ and is meant to
  36. accompany the IRDC document which goes into much more detail
  37. regarding the hardware interfaces, communication ports, software
  38. applications and problem determination.
  39.  
  40. ----
  41. (*1) ONE FOR ALL, ONE FOR ALL 5, ONE FOR ALL 6, ONE FOR ALL 8,
  42.      ONE FOR ALL 12 and The "Universal" Remote are trademarks of
  43.      Universal Electronics Inc.
  44.  
  45. (*2) The limited function version is subject to the following
  46.      limitations:
  47.      i)   3 Second Pause upon program load.
  48.      ii)  Quiet Mode not supported.
  49.      iii) Supports only 2 Button names per file with /F: argument.
  50.  
  51. 2. WARRANTY
  52. --------------------------------------------------------------------
  53. IRDQ is supplied AS IS.  The author disclaims all warranties,
  54. expressed or implied, including, without limitation, the warranties
  55. of merchantability and of fitness for any purpose.  The author
  56. assumes no liability for damages, direct or consequential, which may
  57. result from the use of IRDQ.
  58.  
  59. 3. SETUP INSTRUCTIONS
  60. --------------------------------------------------------------------
  61. Setup Instructions differ based on the model of the ONE FOR ALL
  62. remote that you are using.  It is very important that you correctly
  63. identify the model before using the program.  Refer to the IRDC.DOC
  64. file to identify your remote and then follow the appropriate Setup
  65. Instructions below.
  66.  
  67. SETUP INSTRUCTIONS FOR:
  68. -----------------------
  69.   ONE FOR ALL 6  [URC4000]
  70.   ONE FOR ALL 12 [URC5000]
  71.  
  72. 1) Plug the Special Serial Cable into the PC Serial Port.
  73. 2) Plug the Special Serial Cable into the ONE FOR ALL Remote Control.
  74. 3) Ensure that there are no loose connections.
  75. 4) Run the IRDQ Program.
  76. 5) VERY IMPORTANT: DO NOT TOUCH ANY BUTTONS on the remote control when
  77.    when using the software.
  78. NOTES:
  79. ------
  80. - The author assumes no liability for damages, direct or
  81.   consequential, which may result from the use of IRDQ.
  82. - If you physically press buttons on the keypad while the software
  83.   is communicating with the remote control strange things can happen
  84.   that could affect the operability of your remote control.  If the
  85.   memory contents of your remote control are altered then the only way
  86.   to restore it to normal operation is to have it reloaded by
  87.   Universal Electronics or a local Service Dealer.
  88. --------------------------------------------------------------------
  89.  
  90. SETUP INSTRUCTIONS FOR:
  91. -----------------------
  92.   ONE FOR ALL 5   [URC2005]
  93.   ONE FOR ALL 6A  [URC4005]
  94.   ONE FOR ALL 6A1 [URC4050-1]
  95.   ONE FOR ALL 6A2 [URC4050-2]
  96.   ONE FOR ALL 6B  [URC4005]
  97.   ONE FOR ALL 8   [URC6050]
  98.  
  99. 1) Plug the Special Serial Cable into the PC Serial Port.
  100. 2) Plug the Special Serial Cable into the ONE FOR ALL Remote Control.
  101. 3) Ensure that there are no loose connections.
  102. 4) VERY IMPORTANT: You must physically press a button on the remote
  103.    control and then run the IRDQ program with a button name WITHIN 5
  104.    SECONDS to put the remote online. Once the remote is online it will
  105.    remain online (and will not respond to physical key presses) until
  106.    you explicitly take it offline by running IRDQ with the "OFFLINE"
  107.    button name (or the OFFLINE button within a button file).  The LED
  108.    on the remote will flash twice in acknowledgement of the request.
  109.  
  110. NOTE:
  111. -----
  112. - The author assumes no liability for damages, direct or
  113.   consequential, which may result from the use of IRDQ.
  114.  
  115. 4. COMMAND LINE ARGUMENTS
  116. --------------------------------------------------------------------
  117. DEFAULTS:  If the program is run without any command line arguments
  118.            it will default to COMMPORT 1 & MODEL 6.
  119.  
  120. The following command line arguments can be entered in any order:
  121.  
  122. BUTTON    - Name of Button to be pressed (see BUTTON NAMES).
  123.  
  124. /Annnn(n) - Base I/O Address applicable to User Defined CommPort
  125.             (Must be specified as a decimal number)
  126.             If /I argument is present, but /A is not; then Base
  127.             I/O Address will default to 1016 (3F8 Hex).
  128.  
  129. /Cn  - COMMPORT where n = 1,2,3 or 4
  130.  
  131. /F:[d]:\filespec - File Name containing Button Names of Buttons
  132.                    to be pressed. (eg. /F:C:\IRDQ\TV.ON)
  133.  
  134. /In  - IRQ applicable to User Defined CommPort where n = 1 - 15
  135.        If /A argument is present, but /I is not; then IRQ
  136.        will default to 4.
  137.  
  138. /Mn  - MODEL where n = 5, 6, 6A, 6A1, 6A2, 6B, 8 or 12
  139.  
  140. /Q   - Quiet Mode; Display no messages during program execution
  141.  
  142. /?   - Display Command Line Arguments & Environment Variable syntax
  143.  
  144. NOTE: - COMMAND LINE OPTIONS OVERRIDE ANY SETTINGS STORED WITHIN
  145.         DOS ENVIRONMENT VARIABLE, IRDQ.
  146.       - MULTIPLE OCCURRENCES OF THE SAME COMMAND LINE ARGUMENT
  147.         ARE ACCEPTED; THE LAST INSTANCE WILL BE USED BY IRDQ.
  148.  
  149. 5. IRDQ DOS ENVIRONMENT VARIABLE
  150. --------------------------------------------------------------------
  151. To minimize program size and improve performance, IRDQ does not
  152. support an INI file of program parameters.  However, you can avoid
  153. using command line arguments by setting up a DOS environment
  154. variable that contains program settings.  The DOS environment
  155. variable 'IRDQ' is used to pass settings to IRDQ.EXE.  You use the
  156. DOS 'SET' command to assign a value to an environment variable.
  157. The syntax is:
  158.  
  159.   SET IRDQ=m,c,i,a,q
  160.  
  161.     where: m = Model (5,6,6A,6A1,6A2,6B,8 or 12)
  162.            c = CommPort (1 thru 4)
  163.            i = IRQ (1 - 15)
  164.            a = Base I/O address (must be > 0)
  165.            q = Quiet Mode
  166.  
  167. You do not need to specify values for parameters that you do
  168. not wish to change.  However, IRDQ environment variable parameters
  169. are positional so you must use comma's as placeholders if you
  170. wish to skip a parameter.  Trailing comma placeholders are not
  171. required.  Examples are shown below:
  172.  
  173.    To turn on Quiet Mode:      SET IRDQ=,,,,Q
  174.  
  175.    To set Model to 12:         SET IRDQ=12
  176.  
  177.    To set CommPort to 2:       SET IRDQ=,2
  178.  
  179.    To set Model 12,CommPort 2
  180.     and turn Quiet Mode On:    SET IRDQ=12,2,,,Q
  181.  
  182.    To set IRQ to 5:            SET IRDQ=,,5
  183.  
  184.    To set Model 12,IRQ 5, &
  185.    Base I/O Address* 12832:    SET IRDQ=12,,5,12832,Q   *specify in
  186.                                                         decimal
  187.  
  188. The DOS environment variable only needs to be SET once so a logical
  189. place for it is within your AUTOEXEC.BAT file.
  190.  
  191. 6. BUTTON NAMES
  192. --------------------------------------------------------------------
  193. The following Button Names can be passed directly on the Command
  194. Line as an argument OR within the Button File passed to IRDQ with
  195. the /F: command line argument.
  196.  
  197. +----------------------+-----------------------------------------+
  198. |                      |    ONE FOR ALL MODELS SUPPORTED         |
  199. |                      +------+------+------+------+------+------+
  200. |   BUTTON NAMES       |  5   |  6   |  6A  |  6B  |  8   |  12  |
  201. |   (& Synonyms)       | 2005 | 4000 | 4050 | 4005 | 6050 | 5000 |
  202. +----------------------+------+------+------+------+------+------+
  203. | "<"                  |      |  X   |      |      |      |      |
  204. +----------------------+------+------+------+------+------+------+
  205. | "<<",REW,REWIND      |  X   |  X   |  X   |  X   |  X   |  X   |
  206. +----------------------+------+------+------+------+------+------+
  207. | ">>",FF              |  X   |  X   |  X   |  X   |  X   |  X   |
  208. +----------------------+------+------+------+------+------+------+
  209. | 0                    |  X   |  X   |  X   |  X   |  X   |  X   |
  210. +----------------------+------+------+------+------+------+------+
  211. | 1                    |  X   |  X   |  X   |  X   |  X   |  X   |
  212. +----------------------+------+------+------+------+------+------+
  213. | 2                    |  X   |  X   |  X   |  X   |  X   |  X   |
  214. +----------------------+------+------+------+------+------+------+
  215. | 3                    |  X   |  X   |  X   |  X   |  X   |  X   |
  216. +----------------------+------+------+------+------+------+------+
  217. | 4                    |  X   |  X   |  X   |  X   |  X   |  X   |
  218. +----------------------+------+------+------+------+------+------+
  219. | 5                    |  X   |  X   |  X   |  X   |  X   |  X   |
  220. +----------------------+------+------+------+------+------+------+
  221. | 6                    |  X   |  X   |  X   |  X   |  X   |  X   |
  222. +----------------------+------+------+------+------+------+------+
  223. | 7                    |  X   |  X   |  X   |  X   |  X   |  X   |
  224. +----------------------+------+------+------+------+------+------+
  225. | 8                    |  X   |  X   |  X   |  X   |  X   |  X   |
  226. +----------------------+------+------+------+------+------+------+
  227. | 9                    |  X   |  X   |  X   |  X   |  X   |  X   |
  228. +----------------------+------+------+------+------+------+------+
  229. | A                    |  X   |  X   |  X   |  X   |  X   |  X   |
  230. +----------------------+------+------+------+------+------+------+
  231. | A/B                  |      |      |  X   |      |  X   |  X   |
  232. +----------------------+------+------+------+------+------+------+
  233. | AMP                  |      |      |      |      |  X   |  X   |
  234. +----------------------+------+------+------+------+------+------+
  235. | AUDIO,AUD            |      |      |  X   |      |  X   |      |
  236. +----------------------+------+------+------+------+------+------+
  237. | AUX                  |  X   |      |      |      |      |  X   |
  238. +----------------------+------+------+------+------+------+------+
  239. | AUX1                 |      |  X   |  X   |  X   |  X   |      |
  240. +----------------------+------+------+------+------+------+------+
  241. | AUX2                 |      |  X   |  X   |  X   |  X   |      |
  242. +----------------------+------+------+------+------+------+------+
  243. | B                    |  X   |  X   |  X   |  X   |  X   |      |
  244. +----------------------+------+------+------+------+------+------+
  245. | B/AUDIO              |      |      |      |      |      |  X   |
  246. +----------------------+------+------+------+------+------+------+
  247. | C                    |  X   |  X   |  X   |  X   |  X   |      |
  248. +----------------------+------+------+------+------+------+------+
  249. | C/VIDEO              |      |      |      |      |      |  X   |
  250. +----------------------+------+------+------+------+------+------+
  251. | CABLE,CBL            |  X   |  X   |  X   |  X   |  X   |  X   |
  252. +----------------------+------+------+------+------+------+------+
  253. | CD                   |  X   |  X   |  X   |  X   |  X   |  X   |
  254. +----------------------+------+------+------+------+------+------+
  255. | CH+                  |  X   |  X   |  X   |  X   |  X   |  X   |
  256. +----------------------+------+------+------+------+------+------+
  257. | CH-                  |  X   |  X   |  X   |  X   |  X   |  X   |
  258. +----------------------+------+------+------+------+------+------+
  259. | DISPLAY,DISP         |  X   |      |  X   |  X   |  X   |  X   |
  260. +----------------------+------+------+------+------+------+------+
  261. | ENTER,ENT            |  X   |  X   |  X   |  X   |  X   |  X   |
  262. +----------------------+------+------+------+------+------+------+
  263. | F1                   |      |      |      |      |      |  X   |
  264. +----------------------+------+------+------+------+------+------+
  265. | F2                   |      |      |      |      |      |  X   |
  266. +----------------------+------+------+------+------+------+------+
  267. | F3                   |      |      |      |      |      |  X   |
  268. +----------------------+------+------+------+------+------+------+
  269. | F4                   |      |      |      |      |      |  X   |
  270. +----------------------+------+------+------+------+------+------+
  271. | MAGIC                |  X   |      |  X   |  X   |  X   |      |
  272. +----------------------+------+------+------+------+------+------+
  273. | MUTE                 |  X   |  X   |  X   |  X   |  X   |  X   |
  274. +----------------------+------+------+------+------+------+------+
  275. | PAUSE                |  X   |  X   |  X   |  X   |  X   |  X   |
  276. +----------------------+------+------+------+------+------+------+
  277. | PLAY                 |  X   |  X   |  X   |  X   |  X   |  X   |
  278. +----------------------+------+------+------+------+------+------+
  279. | POWER,PWR            |  X   |  X   |  X   |  X   |  X   |  X   |
  280. +----------------------+------+------+------+------+------+------+
  281. | PROGRAM,PGM          |  X   |      |  X   |  X   |  X   |  X   |
  282. +----------------------+------+------+------+------+------+------+
  283. | RECALL,RCL           |  X   |  X   |  X   |  X   |  X   |  X   |
  284. +----------------------+------+------+------+------+------+------+
  285. | RECORD,REC           |  X   |  X   |  X   |  X   |  X   |  X   |
  286. +----------------------+------+------+------+------+------+------+
  287. | SAT                  |      |      |      |      |      |  X   |
  288. +----------------------+------+------+------+------+------+------+
  289. | SCAN                 |  X   |      |  X   |  X   |  X   |      |
  290. +----------------------+------+------+------+------+------+------+
  291. | SHIFT                |      |      |  X   |  X   |  X   |      |
  292. +----------------------+------+------+------+------+------+------+
  293. | SLEEP                |      |      |      |      |  X   |  X   |
  294. +----------------------+------+------+------+------+------+------+
  295. | STOP                 |  X   |  X   |  X   |  X   |  X   |  X   |
  296. +----------------------+------+------+------+------+------+------+
  297. | TUNER, TUN           |      |      |      |      |  X   |  X   |
  298. +----------------------+------+------+------+------+------+------+
  299. | TV                   |  X   |  X   |  X   |  X   |  X   |  X   |
  300. +----------------------+------+------+------+------+------+------+
  301. | TV/VCR               |      |  X   |      |      |      |      |
  302. +----------------------+------+------+------+------+------+------+
  303. | VCR                  |  X   |  X   |  X   |  X   |  X   |  X   |
  304. +----------------------+------+------+------+------+------+------+
  305. | VIDEO,VID            |      |      |  X   |      |  X   |      |
  306. +----------------------+------+------+------+------+------+------+
  307. | VOL+                 |  X   |  X   |  X   |  X   |  X   |  X   |
  308. +----------------------+------+------+------+------+------+------+
  309. | VOL-                 |  X   |  X   |  X   |  X   |  X   |  X   |
  310. +----------------------+------+------+------+------+------+------+
  311. | OFFLINE              |  X   |      |  X   |  X   |  X   |      |
  312. +----------------------+------+------+------+------+------+------+
  313. | WAIT                 |  X   |  X   |  X   |  X   |  X   |  X   |
  314. +----------------------+------+------+------+------+------+------+
  315.  
  316.  
  317. NOTES: 1) Double Quotes required for <<,<, & >>
  318. -----     You can use REW, FF rather than "<<" and ">>" respectively.
  319.  
  320.        2) The WAIT button does not exist; it simply instructs IRDQ
  321.           to pause for ½ second.  This is useful when you want the
  322.           program to wait for the remote control to "catch up",
  323.           ie. when running a macro.  (When the remote is running a
  324.           macro, it will not act upon additional instructions
  325.           until it has completed the macro).  If you are having
  326.           problems with a button file then try inserting
  327.           additional WAIT commands between the button names.
  328.  
  329.        2) The OFFLINE button does not exist; it instructs specific
  330.           ONE FOR ALL Models to go offline (and respond to physical
  331.           keypresses).
  332.  
  333. 7. PROGRAM OVERVIEW
  334. --------------------------------------------------------------------
  335. When the program loads, it looks for the IRDQ variable in the DOS
  336. Environment and then proceeds to parse it if found.  If any errors
  337. are detected then the program will terminate with an appropriate
  338. message, otherwise it will parse the command line arguments (which
  339. override the IRDQ environment variable).  Once again, if any errors
  340. are found it will terminate with an appropriate message.
  341.  
  342. If the /F: argument was included on the command line then IRDQ will
  343. attempt to open the file and process the button names.  Otherwise,
  344. IRDQ will look for a button name on the command line and execute
  345. it.  Note: If both the /F: argument AND a button name are passed
  346. on the command line, IRDQ will ignore the button name and process
  347. the button file.
  348.  
  349. 8. RELEASE HISTORY - IRDQ Commercial Software
  350. --------------------------------------------------------------------
  351.  Date      Version     Changes
  352. ------   ----------   ----------------------------------------------
  353. APR'96      2.40      -Added support for new URC-4050 chipsets
  354.                        (Models 6A1 & 6A2)
  355.  
  356. OCT'95      2.20      -Added "AUD" and "VID" button synonyms
  357.  
  358. MAR'95      2.12      -Updated keycodes for models URC4005,URC4050 &
  359.                        URC6050 (DISPLAY)
  360.  
  361. FEB'95      2.11      -Upgraded encryption scheme to improve program
  362.                        compatibility
  363.  
  364. JAN'95      2.10      -Updated keycodes for models URC4005,URC4050 &
  365.                        URC6050 (PROGRAM,RECORD,DISPLAY & MUTE keys)
  366.  
  367. NOV'94      2.00      -Added support for 4 additional ONE FOR ALL
  368.                        remote control models (URC2005,URC4005,
  369.                        URC4050,URC6050)
  370.                       -Added Quick Upgrade/Registration Support
  371.                       -Limited Function version distributed with
  372.                        Shareware Version of IRDC.
  373.  
  374. APR'94      1.01      -Corrected Error Message displayed when an
  375.                        invalid Base I/O Address is detected.
  376.  
  377. OCT'93      1.00      -First Public Release
  378.                       -OFA-12 Button Definition Problems Corrected
  379.                        (Mode Buttons, A,B,C, Power, CH+,CH-)
  380.                       -European Date Format Support Added
  381.  
  382. SEP'93      1.00ß     Beta Test
  383.  
  384.  
  385. ------
  386.